home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / p_man / cat3 / File::Spec.Z / File::Spec
Encoding:
Text File  |  1998-10-28  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      FFFFiiiilllleeee::::::::SSSSppppeeeecccc((((3333))))   22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))     FFFFiiiilllleeee::::::::SSSSppppeeeecccc((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       File::Spec - portably    perform    operations on file names
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       use File::Spec;
  13.  
  14.       $x=File::Spec->catfile('a','b','c');
  15.  
  16.       which    returns    'a/b/c'    under Unix.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.       This module is designed to support operations    commonly
  20.       performed on file specifications (usually called "file
  21.       names", but not to be    confused with the contents of a    file,
  22.       or Perl's file handles), such    as concatenating several
  23.       directory and    file names into    a single path, or determining
  24.       whether a path is rooted. It is based    on code    directly taken
  25.       from MakeMaker 5.17, code written by Andreas Koenig, Andy
  26.       Dougherty, Charles Bailey, Ilya Zakharevich, Paul Schinder,
  27.       and others.
  28.  
  29.       Since    these functions    are different for most operating
  30.       systems, each    set of OS specific routines is available in a
  31.       separate module, including:
  32.  
  33.           File::Spec::Unix
  34.           File::Spec::Mac
  35.           File::Spec::OS2
  36.           File::Spec::Win32
  37.           File::Spec::VMS
  38.  
  39.       The module appropriate for the current OS is automatically
  40.       loaded by File::Spec.    Since some modules (like VMS) make use
  41.       of OS    specific facilities, it    may not    be possible to load
  42.       all modules under all    operating systems.
  43.  
  44.       Since    File::Spec is object oriented, subroutines should not
  45.       called directly, as in:
  46.  
  47.           File::Spec::catfile('a','b');
  48.  
  49.       but rather as    class methods:
  50.  
  51.           File::Spec->catfile('a','b');
  52.  
  53.       For a    reference of available functions, pleaes consult the
  54.       _F_i_l_e::_S_p_e_c::_U_n_i_x manpage, which contains the entire set, and
  55.       inherited by the modules for other platforms.    For further
  56.       information, please see the _F_i_l_e::_S_p_e_c::_M_a_c manpage, the
  57.       _F_i_l_e::_S_p_e_c::_O_S_2 manpage, the _F_i_l_e::_S_p_e_c::_W_i_n_3_2 manpage, or
  58.       the _F_i_l_e::_S_p_e_c::_V_M_S manpage.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      FFFFiiiilllleeee::::::::SSSSppppeeeecccc((((3333))))   22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))     FFFFiiiilllleeee::::::::SSSSppppeeeecccc((((3333))))
  71.  
  72.  
  73.  
  74.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.       File::Spec::Unix, File::Spec::Mac, File::Spec::OS2,
  76.       File::Spec::Win32, File::Spec::VMS, ExtUtils::MakeMaker
  77.  
  78.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  79.       Kenneth Albanowski <_k_j_a_h_d_s@_k_j_a_h_d_s._c_o_m>, Andy Dougherty
  80.       <_d_o_u_g_h_e_r_a@_l_a_f_c_o_l._l_a_f_a_y_e_t_t_e._e_d_u>, Andreas Koenig
  81.       <_A._K_o_e_n_i_g@_f_r_a_n_z._w_w._T_U-_B_e_r_l_i_n._D_E>, Tim    Bunce
  82.       <_T_i_m._B_u_n_c_e@_i_g._c_o._u_k>.    VMS support by Charles Bailey
  83.       <_b_a_i_l_e_y@_g_e_n_e_t_i_c_s._u_p_e_n_n._e_d_u>.    OS/2 support by    Ilya
  84.       Zakharevich <_i_l_y_a@_m_a_t_h._o_h_i_o-_s_t_a_t_e._e_d_u>. Mac support by Paul
  85.       Schinder <_s_c_h_i_n_d_e_r@_p_o_b_o_x._c_o_m>.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.